home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / SHMPG305.ZIP;1 / SHAMPAGE.DOC < prev    next >
Encoding:
Text File  |  1992-07-13  |  14.7 KB  |  327 lines
  1.  
  2.                                                                  
  3.  This program compliments of:                      ÷¡∑           ÷¡∑
  4.                                                  / ∫ ∫           ∫ ∫ \
  5.    —∏           —∏       ∏         —∏—∏’∏       ⁄ƒ¬∫¬∫¬ƒ¬ƒ¬ƒ¬ƒ¬ƒ¬∫¬∫¬ƒø
  6.    ≥≥           ≥≥      ≥         ≥≥≥≥≥       flflflfl∫fl∫flflflflflflflflflflfl∫fl∫flflflfl
  7.    ≥≥ —∏ ’∏ ∏ ’ Δµ —∏ ∏ ’µ ’— —∏   ΔµΔµ‘∏          – –           – –
  8.    ≥≥ ≥  ’µ ≥≥≥ ≥≥ ≥  ≥ ≥≥ ≥≥ Δæ   ≥≥≥≥ ≥             FIDO 1:369/2
  9.    œæ œ  ‘œ ‘œæ œæ œ  ‘ ‘œ ‘µ ‘æ   œæœæ‘æ          EchoNet 50:5305/2
  10.                             ≥                       OurNet 65:613/2
  11.      Fort Lauderdale, FL   ‘æ                        WDNet 3090.00
  12.    (305) 523-1717 *HST/DS*
  13.  
  14.  
  15.                                 SHAMpage v3.05
  16.                             (C) 1992 by Rich Waugh
  17.  
  18. Do you ALWAYS answer the page bell, even at 3am? If you do, then you must be
  19. a new SysOp - SHAMpage is not for you! However, if you occasionally turn off
  20. the page function, you might like this fun little door. It allows the user to
  21. have a nice (or not-so-nice... it's up to you) chat with the SysOp, whether
  22. the Sysop is there or not!!!
  23.  
  24. SHAMpage is similar to other "A.I." programs such as ELIZA or CHERI. It is a
  25. little more sophisticated than most, including a routine to randomly vary the
  26. speed at which the "SysOp" types each letter and a random "typo & correction"
  27. routine. It will even vary the length of time it takes to answer each page in
  28. the first place. These delays are all calculated, so the typing speed will
  29. vary on different machines, depending on the speed of the computer, but it is
  30. configurable so you can make it type at realistic speeds on any machine.
  31.  
  32. SHAMpage will look for up to 100 "key" words to which to make an appropriate
  33. response. The key words and their replies are contained in a plain vanilla
  34. ASCii data file (SHAMPAGE.DAT) which you are free to modify to suit your
  35. needs.
  36.  
  37. SHAMpage was originally conceived as a fun, humorous door and the enclosed
  38. sample data file (the one I use) reflects that but, since its release to the
  39. public, I have heard from several SysOps who said it is exactly what they
  40. were looking for in order to answer callers' questions in a serious,
  41. informative manner when the SysOp cannot answer a page (a use which, I must
  42. admit, never crossed my mind when I started writing the code). If that is
  43. your intention, simply edit SHAMPAGE.DAT.
  44.  
  45. CAUTION! If you do modify the data file, please make note of the fact that
  46. each KEY WORD, including NOMATCH, is limited to a maximum of ten (10)
  47. replies. Also, be absolutely certain you match the format of the example
  48. file. Any variation will result in unpredictable and undesirable results. I
  49. strongly recommend you use the included MAINTAIN utility every time you edit
  50. your data file.
  51.  
  52. Although written with WildCat! specifically in mind, SHAMpage should run on
  53. any BBS capable of generating a standard DOOR.SYS or DORINFOx.DEF file. It
  54. is, in fact, currently running on WildCat! v3+, PCBoard and QuickBBS boards.
  55. Features include support for drop to DOS, various timer functions (user's
  56. time left, input timer, SysOp hot keys to increase/decrease user's time left,
  57. etc.), carrier detection, CTS checking and more. You can check the user's
  58. stats while the door is in operation. SHAMpage also writes a log (similar to
  59. WildCat!'s PAGED.CAP) just in case you really WEREN'T around when you had
  60. that little chat with a caller <grin>.
  61.  
  62. Perhaps most importantly, SHAMpage does include a page bell to notify you
  63. when you're being paged and you actually CAN pick up the page and chat with
  64. the user while he is in the door. You can take control of the chat at any
  65. time, transparently to the caller, by hitting [F-7]. When you're finished,
  66. SHAMpage will resume the chat by itself. The SysOp's screen (only) indicates
  67. whenever the chat is live.
  68.  
  69. When the user exits the door by typing Q, X, EXIT, BYE, QUIT or two
  70. consecutive empty lines (SHAMpage also terminates whenever it runs out of
  71. responses to any particular key word, including NOMATCH), he sees a
  72. disclaimer (configurable) which explains the SysOp was unavailable and he was
  73. actually chatting with the computer. If he exits by dropping carrier (some
  74. people have NO sense of humor!) he doesn't get that message <grin>, but the
  75. door notes the dropped carrier in the log and exits gracefully anyway.
  76.  
  77.                     ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ
  78.  
  79. Here's what's required to implement SHAMpage on your board:
  80.  
  81. Make a separate directory where you will run SHAMpage. Unzip all the files in
  82. the archive into this directory. Next, you must modify SHAMPAGE.CFG to
  83. reflect the correct information for your board (see below).
  84.  
  85. EXAMPLE SHAMPAGE.CFG
  86.  
  87. DrawBridge BBS                 <ƒƒ The name of your BBS
  88. Rich                           <ƒƒ SysOp's first name
  89. Waugh                          <ƒƒ SysOp's last name
  90. C:\Wc30\Wcwork\Node1\DOOR.SYS  <ƒƒ Path to & name of DOOR.SYS (or DORINFOx.DEF)
  91. SPLIT                          <ƒƒ WildCat! style split-screen chat (or FULL)
  92. SHAMPAGE.DAT                   <ƒƒ Name of the Key Word Data File
  93. SHAMPAGE.LOG                   <ƒƒ Name of the Log File to write
  94. 1  <ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Delay factor - increase this number
  95. 0  <ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø    to slow down the typing speed, decrease
  96. 23:00  <ƒƒƒƒƒ Time to turn    ≥    it to speed up the typing. For example,
  97. 08:00  <ƒƒø   Page Bell OFF   ≥    making this factor .5 will increase the
  98.           ≥                   ≥    typing speed 100%, making it 2 will slow
  99.           ¿ƒƒ Time to turn    ≥    it down 100%. Experiment with different
  100.               Page Bell ON    ≥    values until you get a realistic typing
  101.                               ≥    speed for your machine. For your
  102.   NOTE: The last two lines    ≥    information, SHAMpage was written and
  103.         are optional (but     ≥    tested on a 286/20 machine and types
  104.         must be entered in    ≥    just about right with this factor set at
  105.         military-style 24:00  ≥    one (1). (Remember, it's SUPPOSED to
  106.         format if used).      ≥    emulate a real human typing, at realistic
  107.                               ≥    human speeds!)
  108.                               ≥
  109.                               ¿ƒƒƒ An integer specifying the type of
  110.                                    handshake you wish to use between the CPU
  111.                                    and modem. Valid numbers are:
  112.                                              0 = NO handshake
  113.                                              1 = XON/XOFF
  114.                                              2 = CTS/RTS
  115.                                              3 = XON/XOFF and CTS/RTS
  116.                                    If you don't know what to put here, make
  117.                                    it 0 or 1. CTS/RTS is for high-speed
  118.                                    modems.
  119.  
  120. NOTE: Due to the fact the remote cursor position is generated by ANSI code,
  121.       if the caller has color screens turned off, SHAMpage will default to
  122.       full-screen chat, not split-screen. This is not a bug. It is intended
  123.       to run this way.
  124.  
  125.                     ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ
  126.  
  127. SHAMpage is run with the following syntax: SHAMpage SHAMPAGE.CFG
  128.  
  129. EXAMPLE MAIN1.BAT (or DOORx.BAT):
  130.  
  131. @Echo Off
  132. Cd \Doors\SHAMpage
  133. SHAMpage SHAMPAGE.CFG
  134.  
  135. NOTE: The batch file above will work only if you have WildCat! set to SHELL
  136.       to doors. This documentation is not intended to be a tutorial on door
  137.       setup. If you've never set up a door before, please refer to page 221
  138.       in your WildCat! manual.
  139.  
  140.   ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  141.   ≥                  OPTIONAL hints for WildCat! SysOps:                    ≥
  142.   √ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ¥
  143.   ≥ To make the caller believe he is really chatting with the SysOp, run    ≥
  144.   ≥ MAKEWILD. From the Main Menu Definition page, change the "Page the      ≥
  145.   ≥ sysop" key to some letter other than P and assign it an access level of ≥
  146.   ≥ 1001 or higher, so nobody has access to it. Next, assign DOS Hook 1 or  ≥
  147.   ≥ DOS Hook 2 to key P. Then set up SHAMpage in MAINx.BAT. If you REALLY   ≥
  148.   ≥ want to fool the caller, run MKWCTEXT and change the "Preparing system  ≥
  149.   ≥ to run a door" prompt to "".                                            ≥
  150.   ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  151.  
  152.  
  153.                       FILES INCLUDED IN SHAMPAGE v3.05:
  154.  
  155. READ.ME!      - IMPORTANT!!! Update information!!!
  156. SHAMPAGE.CFG  - Example configuration file.
  157. SHAMPAGE.DAT  - ASCii data file containing KEY WORDS and responses.
  158. SHAMPAGE.DOC  - The file you're reading now.
  159. SHAMPAGE.EXE  - The door itself.
  160. MAINTAIN.DOC  - Instructions for the SHAMPAGE.DAT maintenance utility.
  161. MAINTAIN.EXE  - SHAMPAGE.DAT maintenance utility.
  162. WHAT'S.NEW    - Documentation of changes from release to release.
  163. DESC.SDI      - Short program description.
  164. FILE_ID.DIZ   - Longer program description.
  165.  
  166.                     ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ
  167.  
  168. SHAMpage is distributed as Nobitchware. I'm not charging anything for it, so
  169. you are NOT entitled to bitch about it!!!
  170.  
  171. I, for one, am sick and tired of people who solicit money for the dumb little
  172. doors/utilities we all find so indespensible, so this one's a freebie. It is
  173. fully functional and contains no time bombs. If you find it handy, give the
  174. DrawBridge a call and thank me. Or, even better, send me your own customized
  175. SHAMPAGE.DAT file. If you don't find it useful, I'll cheerfully refund double
  176. your money!
  177.  
  178.                                   Rich Waugh
  179.  
  180.                     ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ
  181.  
  182. Revision History:
  183.  
  184.  
  185. Ver 3.05:
  186.  
  187. * Made the "exit" message configurable. If SHAMPAGE.DAT contains the Key Word
  188.   EXITMSG, its "keyword responses" (up to four lines) will all be sent, in
  189.   order, upon door termination. If EXITMSG does not appear as a key word, the
  190.   default hard-coded exit message will be used.
  191.  
  192. * SHAMpage now checks for a variable in the data file so you can personalize
  193.   your responses a bit more. You will find that the more personal your
  194.   responses, using such things as your real name, the caller's name and your
  195.   board's name, the more believable the program becomes. The variable name is
  196.   *USER* (upper-case, with the asterisks). If this string occurs anywhere
  197.   within the line, the caller's first name will be substituted in that
  198.   position. This affects the format of the opening lines, where the caller's
  199.   name had previously been inserted automatically and necessitates changes to
  200.   your SHAMPAGE.DAT file. Please see the enclosed SHAMPAGE.DAT for an
  201.   example.
  202.  
  203. * MAINTAIN.EXE has been updated to convert the old SHAMPAGE.DAT to the latest
  204.   format, which supports the changes noted above. Be sure to run it if you
  205.   intend to use your old customized data file.
  206.  
  207. * Added support for DORINFOx.DEF drop file (refer to line 4 in SHAMPAGE.CFG).
  208.   Due to the limited amount of information included in DORINFOx.DEF, the
  209.   [F-2] User's Stats function is not quite as informative in this mode.
  210.   SHAMpage is now running on WildCat! v3+, PCBoard and QuickBBS boards that I
  211.   am aware of. Support for CALLINFO.BBS and/or other BBS drop files can be
  212.   implemented if there is sufficient interest.
  213.  
  214. * Rewrote the error routines to be a bit more specific, for diagnostic
  215.   purposes, whenever an error occurs.
  216.  
  217. * Added a few new key words to SHAMPAGE.DAT.
  218.  
  219.  
  220. Ver 3.02:
  221.  
  222. * Added some new means for the user to exit SHAMpage: by typing Q, X or two
  223.   consecutive empty lines.
  224.  
  225. * Reworked some I/O routines. The transmit buffer now works much better.
  226.  
  227. * Minor color change to match WildCat!'s chat.
  228.  
  229. * Edited SHAMPAGE.DAT to make it somewhat "kinder & gentler." Also added a
  230.   few new key words after rechecking my own SHAMPAGE.LOG
  231.  
  232. * Initial release of MAINTAIN utility for maintaining SHAMPAGE.DAT
  233.  
  234. * Additional information is now written to both SHAMPAGE.LOG and SHAMPAGE.ERR
  235.  
  236. * Cleaned up, optimized and reduced the size of the source (and resultant
  237.   executable) code.
  238.  
  239.  
  240. Ver 3.0:
  241.  
  242. * The Com routines have been completely rewritten to get around the poor
  243.   communications support provided by QuickBASIC. SHAMpage now controls
  244.   COM1 - COM4 at speeds up to 115,200 baud. The serial driver includes
  245.   XON/XOFF and CTS/RTS handshaking. Serial input is interrupt driven, with
  246.   incoming XOFF flow control (if enabled) and/or RTS flow control (if
  247.   enabled) to prevent overrunning the input buffer.
  248.  
  249. * Fixed a local screen write bug when using the FULL style chat and checking
  250.   user's stats. (Who uses SHAMpage in FULL screen chat mode anyway?)
  251.  
  252. * Compiled SHAMpage as a stand-alone program. BRUN45.EXE is no longer
  253.   required.
  254.  
  255.  
  256. Ver 2.1:
  257.  
  258. * Added two (optional) lines to SHAMPAGE.CFG to allow enabling/disabling the
  259.   page bell by the hour.
  260.  
  261. * Changed the page bell to more closely mimic WildCat!'s page bell.
  262.  
  263. * Changed the [F-2] User Stats to be transparent to the caller.
  264.  
  265. * Fixed some bad color changes when using the [] or [] keys.
  266.  
  267.  
  268. Ver 2.0:
  269.  
  270. * Randomized key word responses so they will come up in a different order
  271.   each time the door is run. Previously, they always came up in last-to-first
  272.   order.
  273.  
  274. * Made new option for WildCat! split-screen chat emulation.
  275.  
  276. * SHAMpage now determines DTE rate from DOOR.SYS, not SHAMPAGE.CFG
  277.  
  278. * Modified opening "Paging Sysop... " to mimic WildCat!'s
  279.  
  280. * Modified SysOp's lines 24 & 25 to show other options (which were in
  281.   previous releases - but nobody knew about them!)
  282.  
  283. * Rewrote documentation.
  284.  
  285. * Changed colors to match WildCat!'s
  286.  
  287. * Changed some other colors for cosmetic reasons.
  288.  
  289.  
  290. Ver 1.1:
  291.  
  292. * Fixed drop to DOS bug.
  293.  
  294. * Fixed "User's Stats" bug.
  295.  
  296. * Fixed Add/Subtract Time bug.
  297.  
  298. * Added "Delay Factor" to make the typing rate realistic on any machine.
  299.  
  300.  
  301. Ver 1.0:
  302.  
  303. * First version released to the public.
  304.  
  305.                     ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ
  306.  
  307.             FREE WildCat! 3.x doors/utilities from the DrawBridge
  308.  
  309. BobCheck - Automatically send each new user a personal "Welcome" message
  310.            after they pass BobCat verification. Requires BobCat and Postmstr.
  311.  
  312. CheckSec - Restrict access to any door or DOS hook based on the caller's age
  313.            OR security level.
  314.  
  315. MailChek - Check if last caller left any messages.
  316.  
  317. QwkQuote - OLX compatable reply quote maker.
  318.  
  319. TickFix  - Change the file name extension in *.TIC's from LZH or ARJ to ZIP.
  320.            For those who convert LZH & ARJ files to ZIP before tossing.
  321.  
  322. SHAMpage - Answer ALL SysOp pages - whether you're around or not!
  323.  
  324. ScrbNtfy - Notify players it is their move in one or more Scrabble door games
  325.            via a personal message addressed to them. Requires Postmstr.
  326.  
  327.